home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 3 / CD ACTUAL 3.iso / linux / sonido / mod-0.000 / mod-0 / mod / README < prev    next >
Encoding:
Text File  |  1994-11-18  |  5.1 KB  |  133 lines
  1. 'mod' - plays music modules (MOD/MTM/ULT/S3M) on a GUS under Linux
  2. ------------------------------------------------------------------
  3.  
  4. The goal of this project of mine is to be able to play all the Amiga
  5. ProTracker modules as they sound on a real Amiga (as closely as the
  6. hardware will permit). For fun I added support for a couple of
  7. PC-formats too. There is currently support for MODs (15/31-instrument,
  8. up to 32 voices), MTMs, ULTs and S3Ms.
  9.  
  10. There are quite a few changes since the previously released version
  11. 0.1 (the code about trippled in size :) The major points being an
  12. interactive ncurses-based interface and support for other formats. See
  13. CHANGES for details.
  14.  
  15. I used ncurses 1.8.5, so I won't guarantee it will work with other
  16. versions (but try it with whatever version you have installed - the
  17. worst thing that can happen is a messed up screen).
  18.  
  19. This release requires at least version 3.0 of the VoxWare sounddriver
  20. (or if it isn't available yet, ALPHA-version 2.99 from 940911 or later
  21. will do). Note that you need kernel-version 1.1.48 or above for this
  22. version of VoxWare (and the version of VoxWare in 1.1.48 isn't the one
  23. you need). Don't we all hate how this upgrading-spiral seems to go on
  24. for ever and ever :-(
  25.  
  26. A suitable ALPHA-version is available at:
  27.  
  28. ftp.funet.fi:/pub/Linux/ALPHA/sound/v3.0-proto-940925.tar.gz
  29.  
  30. (this directory is hidden, so you won't see it until you 'cd' to it)
  31.  
  32. Note: This is ALPHA software, so you are on your own (though I should
  33. mention that I've been using the above version for more than a month and
  34. it has caused me no problems whatsoever).
  35.  
  36. Make sure you include "MIDI interface support" when you configure the
  37. sound-driver.
  38.  
  39. With the above version there are no problems with soundcard.h (no need
  40. to use a copy from an old version of VoxWare), and you no longer need
  41. to define GUS_USE_CHN_MAIN_VOLUME (not for 'mod' anyways).
  42.  
  43. If you have an earlier version it WILL NOT work. 'mod' depends on some
  44. important fixes to the sequencer-drivers (specifically the addition of
  45. non-blocking IO and a bugfixed select()).
  46.  
  47. If you are having trouble with skips in the soundoutput during heavy
  48. disk-activity, you could try to enable interrupt unmasking using the
  49. 'hdparm' utility. They supposedly decrease the interrupt-latency and
  50. gives the sounddriver a better chance to get it's interrupts served.
  51.  
  52. Packed modules are now supported (requires the external programs gzip,
  53. lharc, unzip and unarj). If these programs are not installed 'mod'
  54. will still work, but files packed with the corresponding packers can't
  55. be loaded.
  56. If you are having trouble loading some module packed with anything but
  57. gzip it could be that the text output from your version is different
  58. from mine. If so, please send me the output of the command 'xxx l
  59. modulename.suffix' (or whatever option is used to list the contents of
  60. the archive) and I'll supply a fix. The versions I am using are the
  61. ones that come with stock Slackware 2.0.
  62.  
  63. Support for all the above packers was added mainly because most
  64. modules on ftp-sites are packed with lha or some other packer. Now you
  65. can just fetch them and play them without (un/re)packing. It doesn't
  66. matter if there are a couple of small text-files in the archive, 'mod'
  67. will play the correct file. Note that most unpackers are slower than
  68. gzip, so you might want to repack them if loading is too slow (for
  69. example, lha is quite a bit slower than gzip).
  70.  
  71.  
  72. Installing mod
  73. --------------
  74.  
  75. 1) Upgrade kernel (>= 1.1.48) and/or sounddriver (>=940911). Don't forget
  76.    to copy the kernel-image to the right place and rerun LILO.
  77.  
  78.    Skip this step if you already are on the bleeding edge (or if you are
  79.    reading this a long time after I am writing it :)
  80.  
  81. 2) Configure 'mod' by editing the makefile (most people won't have to
  82.    change anything, but take a look at it to make sure).
  83.    
  84. 3) make all
  85.  
  86. 4) make install
  87.  
  88. Try it out! (for zsh-users: mod -r /**/*.mod  ;-)
  89.  
  90. NOTE: Don't make 'mod' suid/sgid as it contains calls to system().
  91.       (There really is no reason to do it)
  92.  
  93.  
  94. Invoking mod
  95. ------------
  96.  
  97. Try 'mod', 'mod -h' or 'man mod'.
  98.  
  99.  
  100. Credits
  101. -------
  102.  
  103. Linus Torvalds and all the people that made the Linux OS what it is today.
  104.  
  105. Hannu Savolainen for his VoxWare sounddriver.
  106.  
  107. Advanced Gravis for their EXCELLENT soundcard.
  108.  
  109. Dr.Awesome for his great modules (major reason to why I started this project :)
  110.  
  111. kurt.kennett@gravis.com for his MODFIL10.TXT that helped me understand the
  112. basics of the module format before digging into the original sources for
  113. the gory details.
  114.  
  115. And of course Karsten Obarski for creating the MOD-format (as hideous as it
  116. may be :-)
  117.  
  118. Also thanks to Peter Tufvesson for suggestions and bugreports.
  119.  
  120. Future version and bugreports
  121. -----------------------------
  122.  
  123. Feel free to report bugs or send me suggestions for features that you
  124. would like to see implemented. I have put in most of the features I
  125. wanted to see in a player appart from what is in the TODO-list, so if
  126. you have any ideas tell me.
  127.  
  128. When it comes to bugreports I am especially interested in reports of
  129. modules that play incorrectly, or won't be loaded even though it can
  130. be loaded by the composer it was created with.
  131.  
  132. /Mikael Nordqvist (mech@df.lth.se or d91mn@efd.lth.se)
  133.